home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm2 / pcbedit.zip / PCBEDIT.DOC next >
Text File  |  1993-02-25  |  25KB  |  657 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                     PCBEdit
  22.  
  23.                                   Version 1.00
  24.  
  25.                             Wide Area Beta Release 2
  26.  
  27.                                 18 February 1993
  28.  
  29.  
  30.  
  31.               Copyright (C) 1993, Clark Development Company, Inc.
  32.  
  33.                         Clark Development Company, Inc.
  34.                                 P.O. Box 571365
  35.                              Murray, UT  84157-1365
  36.  
  37.                              Sales - (800) 356-1686
  38.                               FAX - (801) 261-8987
  39.                          Voice Support - (801) 261-1686
  40.                           BBS Support - (801) 261-8976
  41.  
  42.                          Written by Scott Dale Robison
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                             LICENSE TO USE AGREEMENT
  54.                             ------------------------
  55.  
  56.  
  57. Clark Development Company (CDC) grants to the purchaser of PCBoard
  58.  
  59. Professional Bulletin Board Software (PCBoard) a nonexclusive license to
  60.  
  61. use PCBEdit.  PCBEdit may only be used by purchasers of PCBoard.
  62.  
  63. Contact CDC for purchasing information.  The purchaser is licensed to
  64.  
  65. use PCBEdit according to the same terms and conditions as found in the
  66.  
  67. PCBoard LICENSE TO USE AGREEMENT located on the software envelope
  68.  
  69. included with your PCBoard package.
  70.  
  71.  
  72. If the purchaser transfers ownership of PCBoard to another party, the
  73.  
  74. right to use PCBEdit is also transferred.
  75.  
  76.  
  77. PCBEdit is provided at no cost to purchasers of PCBoard.  CDC makes no
  78.  
  79. warranties of any kind, expressed or implied, with respect to the
  80.  
  81. quality, performance, accuracy, or fitness of PCBEdit.  CDC assumes no
  82.  
  83. responsibility for any decisions made or actions taken on the part of
  84.  
  85. the purchaser because of the use of PCBEdit.  In no event shall CDC, or
  86.  
  87. any of its representatives, be liable for any loss of profit or damage
  88.  
  89. arising from the use or inability to use PCBEdit even if CDC or an
  90.  
  91. authorized agent of CDC has been advised of the possibility of damage.
  92.  
  93.  
  94. CDC reserves the right to make changes, enhancements, and improvements
  95.  
  96. to PCBEdit at any time and without notice.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                                  USING PCBEDIT
  104.                                  -------------
  105.  
  106. The documentation for PCBEdit is still under development.  However,
  107. since you've all been clamoring for it for *SO* long now, we've decided
  108. to go ahead and make it available for you to use right now, rather than
  109. forcing you to wait for PCBoard Version 15 to be released.
  110.  
  111. PCBEdit is not meant to replace programs such as TheDraw or PCBDraw.
  112. They are still incredibly useful for screen design.  PCBEdit is designed
  113. to allow you to write what we call "information intensive" display files 
  114. (such as NEWS and BLT files), as opposed to "display intensive" files 
  115. (such as WELCOME and BRDM.)
  116.  
  117. PCBEdit should be installed in your PCB subdirectory (or whereever you
  118. have installed your PCBoard EXE files.)  It may be set up as an editor
  119. in PCBoard System Manager (PCBSM) option G (Define Text & Graphics
  120. Editors.)  Because it deals with @X codes and @ macros, it can be used
  121. to design all files, eliminating the need for separate graphics display
  122. files.
  123.  
  124. PCBEdit is used just as you would use any editor:  PCBEDIT FILENAME.  It
  125. supports many configuration options which may be specified either on the
  126. command line, in an environment variable, or in a configuration file.
  127. (More on this later.)
  128.  
  129. A couple of notes on getting help.  First, there is a complete reference
  130. of commands and configuration options available via the Alt-H key when
  131. editing.  Alt-W goes to an information screen.
  132.  
  133.  
  134.  
  135.                                 STARTING PCBEDIT
  136.                                 ----------------
  137.  
  138. The PCBEdit command line takes the following format:
  139.  
  140.     PCBEDIT [/OPTION ...] [FILENAME]
  141.  
  142. The following are valid /option's:
  143.  
  144.     /AT                 /ATMAC              /ATX                /BAK
  145.     /CATTR              /COLOR              /DIALOGATTR         /DIALOGDIRATTR
  146.     /DIALOGDRVATTR      /DIALOGFILEATTR     /DIALOGHLATTR       /DIALOGOPTATTR
  147.     /DOS                /HELPATTR           /HELPHLATTR         /LLEND
  148.     /MACRO              /MATTR              /MONO               /NOAT
  149.     /NOATX              /NOBAK              /NODOS              /NOQUICK
  150.     /NOSNOW             /QUICK              /RIBATTR            /RIBHLATTR
  151.     /SET                /SNOW               /STARTATTR          /STATATTR
  152.     /STATUS             REM /
  153.  
  154. Any valid DOS filename may be used.  [Of course, you probably don't want
  155. to use PCBEdit to edit an EXE or COM file!]  :)
  156.  
  157.  
  158.  
  159.                                 STARTUP OPTIONS
  160.                                 ---------------
  161.  
  162. /AT - /AT
  163.     Forces PCBEdit to interpret @ macros (and @X codes if /ATX is in
  164.     effect).  (Default)
  165.  
  166. /ATMAC - /ATMAC:@MAC@[:TEXT]
  167.     Replaces the default text (used to preview a file) associated with
  168.     the specified @ macro with new text.
  169.         @MAC@ -- the @ macro to modify
  170.         TEXT -- (optional) the new default text (for preview purposes)
  171.             to assign to @MAC@; if not specified, reverts to the
  172.             original default text
  173.  
  174. /ATX - /ATX
  175.     If /AT is in effect, forces PCBEdit to interpret @X codes.
  176.     (Default)
  177.  
  178. /BAK - /BAK
  179.     Forces PCBEdit to keep backup files.  (Default)
  180.  
  181. /CATTR - /CATTR
  182.     Updates all configurable attributes with default values for a color
  183.     display adapter.  (Default)
  184.  
  185. /COLOR - /COLOR
  186.     Forces PCBEdit to use a color display adapter card.
  187.  
  188. /DIALOGATTR - /DIALOGATTR:ATTR
  189.     Changes the default attribute used for the file select dialog
  190.     screen.
  191.         ATTR -- the decimal value of the new attribute to use
  192.  
  193. /DIALOGDIRATTR - /DIALOGDIRATTR:ATTR
  194.     Changes the default attribute used for displaying directory names on
  195.     the file select dialog screen.
  196.         ATTR -- the decimal value of the new attribute to use
  197.  
  198. /DIALOGDRVATTR - /DIALOGDRVATTR:ATTR
  199.     Changes the default attribute used for displaying drive letters on
  200.     the file select dialog screen.
  201.         ATTR -- the decimal value of the new attribute to use
  202.  
  203. /DIALOGFILEATTR - /DIALOGFILEATTR:ATTR
  204.     Changes the default attribute used for displaying file names on the
  205.     file select dialog screen.
  206.         ATTR -- the decimal value of the new attribute to use
  207.  
  208. /DIALOGHLATTR - /DIALOGHLATTR:ATTR
  209.     Changes the default attribute used for displaying highlighted items
  210.     on the file select dialog screen.
  211.         ATTR -- the decimal value of the new attribute to use
  212.  
  213. /DIALOGOPTATTR - /DIALOGOPTATTR:ATTR
  214.     Changes the default attribute used for displaying command options on
  215.     the file select dialog screen.
  216.         ATTR -- the decimal value of the new attribute to use
  217.  
  218.  
  219.  
  220. /DOS - /DOS
  221.     Forces PCBEdit to allow shells to DOS.  (Default)
  222.  
  223. /HELPATTR - /HELPATTR:ATTR
  224.     Changes the default attribute used for help screens.
  225.         ATTR -- the decimal value of the new attribute to use
  226.  
  227. /HELPHLATTR - /HELPHLATTR:ATTR
  228.     Changes the default attribute used for highlighted portions of
  229.     help screens.
  230.         ATTR -- the decimal value of the new attribute to use
  231.  
  232. /LLEND - /LLEND:ASC[;ASC[...]]
  233.     Specifies a different character sequence to be appended to the last
  234.     line of a file.  (By default, the last line is written with a
  235.     carriage return/ line feed appended to it.  With this switch, you
  236.     can change it to several carriage return/line feed pairs, an end of
  237.     file character, etc.)
  238.         ASC -- any valid decimal ASCII code (0 - 255)
  239.  
  240. /MACRO - /MACRO:FILENAME.EXT
  241.     Loads the specified macro file.
  242.         FILENAME.EXT -- a valid DOS filename used to specify the desired
  243.             macro file
  244.  
  245. /MATTR - /MATTR
  246.     Updates all configurable attributes with default values for a
  247.     monochrome display adapter.
  248.  
  249. /MONO - /MONO
  250.     Forces PCBEdit to use a monochrome display adapter card.
  251.  
  252. /NOAT - /NOAT
  253.     Forces PCBEdit to not interpret @ macros or @X codes (regardless of
  254.     whether or not /ATX is in effect).
  255.  
  256. /NOATX - /NOATX
  257.     Forces PCBEdit to ignore @X codes and to display all text in the
  258.     attribute specified via the /STARTATTR option.
  259.  
  260. /NOBAK - /NOBAK
  261.     Forces PCBEdit to not keep backup files.
  262.  
  263. /NODOS - /NODOS
  264.     Forces PCBEdit to not allow shells to DOS.
  265.  
  266. /NOQUICK - /NOQUICK
  267.     Displays the welcome screen when PCBEdit starts.
  268.  
  269. /NOSNOW - /NOSNOW
  270.     Tells PCBEdit to not test for CGA screen snow.  (Default)
  271.  
  272. /QUICK - /QUICK
  273.     Circumvents display of the welcome screen at program start.
  274.     (Default)
  275.  
  276. /RIBATTR - /RIBATTR:ATTR
  277.     Changes the default attribute used for the code ribbon.
  278.         ATTR -- the decimal value of the new attribute to use
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285. /RIBHLATTR - /RIBHLATTR:ATTR
  286.     Changes the default attribute used for the high-lighted portion of
  287.     the code ribbon.
  288.         ATTR -- the decimal value of the new attribute to use
  289.  
  290. /SET - /SET:FILENAME.EXT
  291.     Loads the specified function key character set file.
  292.         FILENAME.EXT -- a valid DOS filename used to specify the desired
  293.             function key character set file
  294.  
  295. /SNOW - /SNOW
  296.     Tells PCBEdit to test for CGA screen snow.
  297.  
  298. /STARTATTR - /STARTATTR:ATTR
  299.     Changes the default attribute used for the edit buffer.
  300.         ATTR -- the decimal value of the new attribute to use
  301.  
  302. /STATATTR - /STATATTR:ATTR
  303.     Changes the default attribute used for the status line.
  304.         ATTR -- the decimal value of the new attribute to use
  305.  
  306. /STATUS - /STATUS:TYPE
  307.     Changes the default status bar type.
  308.         TYPE -- one of the following:
  309.             0 = detailed status bar with code ribbon  (Default)
  310.             1 = function key status bar with code ribbon
  311.             2 = no status bar or code ribbon
  312.  
  313. REM /... - REM /COLOR
  314.     Removes the startup option temporarily from processing (works with
  315.     any option that begins with a forward slash [/], including options
  316.     not currently defined [REM /BOB]).
  317.  
  318.  
  319. If you need to enter a startup option that with an embedded space,
  320. surround the entire option with quotes.  Quotes cannot be included in an
  321. option. For example:
  322.  
  323.     PCBEDIT "/ATMAC:@USER@:SCOTT ROBISON"
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.                            SPECIFYING STARTUP OPTIONS
  331.                            --------------------------
  332.  
  333. There are three ways of specifying startup options.  The first is on the
  334. PCBEdit command line.  For example:
  335.  
  336.     PCBEDIT /NOQUICK /MACROS:MAIN.MAC /SET:MAIN.SET NEWSG
  337.  
  338. The second means of specifying startup options is through the PCBEDIT
  339. environment variable, which you could SET in your AUTOEXEC.BAT file.  An
  340. example line would look like this:
  341.  
  342.     SET PCBEDIT=/QUICK "/MACRO:@USER@:SCOTT ROBISON"
  343.  
  344. Finally, startup options may be specified in a a configuration file.  It
  345. is named PCBEDIT.CFG and can be located in the same directory as
  346. PCBEDIT.EXE or in the current directory.  It can be created with any
  347. text editor, may have as many lines as necessary, and may have several
  348. options on one line, as long as all lines are limited to 127 characters
  349. or less.  Here's an example:
  350.  
  351.     +----------------------------------------------------------------------+
  352.     |                                                                      |
  353.     |  /QUICK /MACROS:MAIN.MAC /SET:MAIN.SET                               |
  354.     |  "/MACRO:@USER@:SCOTT ROBISON"  /MACRO:@FIRSTU@:SCOTT                |
  355.     |  /MACRO:@FIRST@:Scott  REM /NOQUICK  /CATTR NEWSG                    |
  356.     |                                                                      |
  357.     +----------------------------------------------------------------------+
  358.  
  359. PCBEdit searches for startup options in the following order:
  360. PCBEDIT.CFG (first in directory with PCBEdit, then in the current
  361. directory); PCBEDIT environment variable; PCBEDIT command line.  In this
  362. way, an option in the PCBEDIT.EXE directory configuration file can be
  363. overridden by another option later in the same file, in the other
  364. configuration file, environment variable or command line; an option in
  365. the current directory configuration file can be overridden by an option
  366. later in the same file, in the environment variable or on the command
  367. line, and so on.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.                                  PCBEDIT MACROS
  375.                                  --------------
  376.  
  377. Fifteen sets of user-defined macros are supported by PCBoard.  Each set
  378. consists of ten strings that may be accessed via the F1 - F10 function
  379. keys. Different sets may be accessed by utilizing the
  380. Shift-Alt-F1 - Shift-Alt-F10 keys for sets 1 - 10 and the
  381. Shift-^F1 - Shift-^F5 keys for sets 11 - 15.  The macros may be selected
  382. from and maintained with the Alt-G key.  Each macro may consist of
  383. whatever text the user would like.  Additionally, the following special
  384. sequences are recognized by PCBEdit:
  385.  
  386.     \XXXX - Backslash followed by 4 hex digits will be converted to a
  387.             keyboard code and stuffed in the keyboard buffer (Sorry, no
  388.             list of keyboard codes yet; they will be forthcoming)
  389.  
  390.     \X    - Stuffs the character following backslash in the keyboard
  391.             buffer (\\ to stuff a literal backslash)
  392.  
  393.     \     - By itself at the end of a macro with nothing following it
  394.             will stuff a literal backslash in the keyboard buffer
  395.  
  396.     ~X    - Stuffs the lowercase letter X in the keyboard buffer
  397.  
  398.     ~#    - Stuffs the code for function key F# in the keyboard buffer
  399.  
  400.     ~     - By itself at the end of a macro with nothing following it
  401.             will stuff a literal tilde in the keyboard buffer
  402.  
  403.     #X    - Stuffs the uppercase letter X in the keyboard buffer
  404.  
  405.     ##    - Stuffs the code for function key Shift-F# in the keyboard
  406.             buffer
  407.  
  408.     #     - By itself at the end of a macro with nothing following it
  409.             will stuff a literal pound sign in the keyboard buffer
  410.  
  411.     ^X    - Stuffs a control X in the keyboard buffer
  412.  
  413.     ^#    - Stuffs the code for function key control F# in the keyboard
  414.             buffer
  415.  
  416.     ^     - By itself at the end of a macro with nothing following it
  417.             will stuff a literal carat in the keyboard buffer
  418.  
  419.     !X    - Stuffs an alt X in the keyboard buffer
  420.  
  421.     !#    - Stuffs the code for function key alt F# in the keyboard
  422.             buffer
  423.  
  424.     !     - By itself at the end of a macro with nothing following it
  425.             will stuff a literal exclamation point in the keyboard
  426.             buffer
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                             KEYCODE TABLE FOR MACROS
  434.                             ------------------------
  435.  
  436.  
  437.    Ctrl-A = ^A   Alt-A = !A   Backspace  = ^H      Backslash         (\) = \\
  438.    Ctrl-B = ^B   Alt-B = !B   TAB        = ^I      Tilde             (~) = \~
  439.    Ctrl-C = ^C   Alt-C = !C   Line Feed  = ^J      Pound Sign        (#) = \#
  440.    Ctrl-D = ^D   Alt-D = !D   ^ENTER     = ^J      Carat             (^) = \^
  441.    Ctrl-E = ^E   Alt-E = !E   ENTER      = ^M      Exclamation Point (!) = \!
  442.    Ctrl-F = ^F   Alt-F = !F   ESC        = \001B
  443.    Ctrl-G = ^G     Alt-G = !G
  444.    Ctrl-H = ^H     Alt-H = !H   Shift-TAB  = \010F
  445.    Ctrl-I = ^I   Alt-I = !I
  446.    Ctrl-J = ^J     Alt-J = !J   INS         = \0152
  447.    Ctrl-K = ^K     Alt-K = !K   DEL         = \0153
  448.    Ctrl-L = ^L   Alt-L = !L
  449.    Ctrl-M = ^M   Alt-M = !M   LEFT       = \014B   Ctrl-LEFT  = \0173
  450.    Ctrl-N = ^N   Alt-N = !N   RIGHT      = \014D   Ctrl-RIGHT = \0174
  451.    Ctrl-O = ^O   Alt-O = !O   UP         = \0148
  452.    Ctrl-P = ^P   Alt-P = !P   DOWN       = \0150
  453.    Ctrl-Q = ^Q   Alt-Q = !Q   PGUP       = \0149   Ctrl-PGUP  = \0184
  454.    Ctrl-R = ^R   Alt-R = !R   PGDN       = \0151   Ctrl-PGDN  = \0176
  455.    Ctrl-S = ^S   Alt-S = !S   HOME       = \0147   Ctrl-HOME  = \0177
  456.    Ctrl-T = ^T   Alt-T = !T   END        = \014F   Ctrl-END   = \0175
  457.    Ctrl-U = ^U   Alt-U = !U
  458.    Ctrl-V = ^V   Alt-V = !V
  459.    Ctrl-W = ^W   Alt-W = !W
  460.    Ctrl-X = ^X   Alt-X = !X
  461.    Ctrl-Y = ^Y   Alt-Y = !Y
  462.    Ctrl-Z = ^Z   Alt-Z = !Z
  463.  
  464.  
  465.          F1  = ~1      Shift-F1    = #1     Ctrl-F1  = ^1       Alt-F1  = !1
  466.          F2  = ~2      Shift-F2    = #2     Ctrl-F2  = ^2       Alt-F2  = !2
  467.          F3  = ~3      Shift-F3    = #3     Ctrl-F3  = ^3       Alt-F3  = !3
  468.          F4  = ~4      Shift-F4    = #4     Ctrl-F4  = ^4       Alt-F4  = !4
  469.          F5  = ~5      Shift-F5    = #5     Ctrl-F5  = ^5       Alt-F5  = !5
  470.          F6  = ~6      Shift-F6    = #6     Ctrl-F6  = ^6       Alt-F6  = !6
  471.          F7  = ~7      Shift-F7    = #7     Ctrl-F7  = ^7       Alt-F7  = !7
  472.          F8  = ~8      Shift-F8    = #8     Ctrl-F8  = ^8       Alt-F8  = !8
  473.          F9  = ~9      Shift-F9    = #9     Ctrl-F9  = ^9       Alt-F9  = !9
  474.          F10 = ~0      Shift-F10 = #0     Ctrl-F10 = ^0       Alt-F10 = !0
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.                                  @X COLOR CODES
  483.                                  --------------
  484.  
  485.     +--------+------------------------------+------------------------------+
  486.     |        |                              |                              |
  487.     |  Code  |      Background Meaning      |      Foreground Meaning      |
  488.     |        |                              |                              |
  489.     +--------+------------------------------+------------------------------+
  490.     |        |                              |                              |
  491.     | 0 ( 0) |      Black       (No Blink)    |         Black                   |
  492.     |        |                              |                              |
  493.     | 1 ( 1) |      Blue          (No Blink)    |         Blue                   |
  494.     |        |                              |                              |
  495.     | 2 ( 2) |      Green       (No Blink)    |         Green                   |
  496.     |        |                              |                              |
  497.     | 3 ( 3) |      Cyan          (No Blink)    |         Cyan                   |
  498.     |        |                              |                              |
  499.     | 4 ( 4) |      Red          (No Blink)    |         Red                   |
  500.     |        |                              |                              |
  501.     | 5 ( 5) |      Magenta      (No Blink)    |         Magenta               |
  502.     |        |                              |                              |
  503.     | 6 ( 6) |      Brown       (No Blink)    |         Brown                   |
  504.     |        |                              |                              |
  505.     | 7 ( 7) |      Light Grey  (No Blink)    |         Light Grey            |
  506.     |        |                              |                              |
  507.     | 8 ( 8) |      Black       (Blink)        |         Dark Grey               |
  508.     |        |                              |                              |
  509.     | 9 ( 9) |      Blue          (Blink)        |         Light Blue            |
  510.     |        |                              |                              |
  511.     | A (10) |      Green       (Blink)        |         Light Green           |
  512.     |        |                              |                              |
  513.     | B (11) |      Cyan          (Blink)        |         Light Cyan            |
  514.     |        |                              |                              |
  515.     | C (12) |      Red          (Blink)        |         Light Red               |
  516.     |        |                              |                              |
  517.     | D (13) |      Magenta      (Blink)        |         Light Magenta           |
  518.     |        |                              |                              |
  519.     | E (14) |      Brown       (Blink)        |         Yellow                |
  520.     |        |                              |                              |
  521.     | F (15) |      Light Grey  (Blink)        |         White                   |
  522.     |        |                              |                              |
  523.     +--------+------------------------------+------------------------------+
  524.  
  525.  
  526. @X color codes are implemented in the following format:  @XBF, where the
  527. B is the background attribute and the F is the foreground attribute,
  528. both taken from the above table.  In other words, @XCF would be flashing
  529. white letters on a red background.  There are two exceptions:
  530.  
  531.  
  532.     @X00 - Save the current attribute
  533.     @XFF - Recall the last attribute saved with @X00
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.                            STARTUP OPTION ATTRIBUTES
  542.                            -------------------------
  543.  
  544. To calculate the attribute (color code) for a startup option (such as
  545. /HELPATTR), take the decimal value (in parenthesis) for the desired
  546. background, multiply it by 16, and add the decimal value (in
  547. parenthesis) for the desired foreground.
  548.  
  549. For example, if you wanted to use flashing bright white letters on a red
  550. background, you would use the following set of calculations:
  551.  
  552.     (B * 16) + F =
  553.     ((RED w/BLINKING FOREGROUND) * 16) + BRIGHT WHITE =
  554.     (12 * 16) + 15 =
  555.     192 + 15 =
  556.     207
  557.  
  558. If you wanted to use that for the help attribute, you would include a
  559. startup option of the following format:
  560.  
  561.     /HELPATTR:207
  562.  
  563.  
  564.  
  565.                               SUPPORT FOR PCBEDIT
  566.                               -------------------
  567.  
  568. If you have a question about PCBEdit, first read this document
  569. completely.  If you wish to report a bug in PCBEdit, read the
  570. HISTORY.TXT document completely.  If you can't find the answer to your
  571. question or a mention of your bug being fixed, then leave a message to
  572. SCOTT ROBISON in the BETA conference (6) on the SALT AIR BBS.  Please
  573. include in the message the wide area beta version number and/or release
  574. date of the software (found at the top of this document and on the
  575. information screen (Alt-W key) in PCBEdit).  Depending on the
  576. circumstances, We may also need to get a copy of the configuration
  577. and/or display files in use at the time, so keep them handy.  However,
  578. you will not need to upload them unless requested.  Remember, this is
  579. *BETA* software.  It is not, nor should it be expected to be perfect.
  580. Be sure to save your work often, and preferably back it up before you
  581. attempt to edit it.  While this program has been tested extensively in
  582. house, you are bound to do something we didn't take into account.
  583. Please report any problems and we will fix them as quickly as possible.
  584.  
  585. Summary:
  586.  
  587.     Use the SALT AIR BBS BETA conference (6) for PCBEdit reports.
  588.     Leave them to SCOTT ROBISON.
  589.     Tell him what version/beta release you are using.
  590.     Be prepared to supply him with samples of configuration and/or
  591.         display files.
  592.     Be patient!  :)
  593.  
  594.                           ANSWERS TO COMMON QUESTIONS
  595.                           ---------------------------
  596.  
  597. Q:  The Alt-O optimize function doesn't seem to work.  What's wrong?
  598.  
  599. A:  It is being worked on.  We haven't experienced it removing necessary
  600.     codes; it just won't always remove unnecessary codes (which is it's
  601.     function).  It will never be perfect; there are too many potential
  602.     cases for it to reliably take into account.  However, it will
  603.     improve with time.  If you feel you have a case that is OBVIOUSLY
  604.     incorrect, upload the display file to SALT AIR and leave a message
  605.     to SCOTT ROBISON to take a look at it with the PCBEdit Alt-O
  606.     command.
  607.  
  608.  
  609. Q:  PCBEdit saves files with a carriage return/line feed after the last
  610.     line, but I need an end of file character after the last line. Is
  611.     there a way to accomplish this?
  612.  
  613. A:  There are a couple of ways to do this.  One is to position yourself
  614.     at the end of the last line just before saving it and hit ^Z or
  615.     Alt-26 (the EOF character).  Another option, if you want it to save
  616.     that way everytime you save the file, is to use the /LLEND option to
  617.     change the last line ending sequence of characters.  /LLEND:26 will
  618.     save an EOF after the last line instead of a CR-LF.
  619.  
  620.  
  621. Q:  When I change background colors and type spaces all the way to the
  622.     end of the line it displays as expected.  But sometimes if I move
  623.     the cursor off of that line (and always after a save and reload of
  624.     the same file) it background color no longer appears across the
  625.     entire line.  What happened?
  626.  
  627. A:  The effect you desire is automatic when using screen oriented
  628.     editors (such as TheDraw and PCBDraw) because the save the entire
  629.     screen (80X25), and that's why you can only edit that size of
  630.     display with those programs. However, since PCBEdit functions more
  631.     as a text editor instead of a screen editor, it attempts to optimize
  632.     the output of the file before saving by stripping trailing spaces
  633.     before writing the file to disk.  This is easily avoided by simply
  634.     including a color change at the end of the line back to the original
  635.     background color.  For example, to include a blue bar on a line
  636.     (with nothing else) on a line, you could type in something like
  637.     this:
  638.  
  639.         @X00@X1F     @XFF
  640.  
  641.     Since the @XFF appears after the spaces, the spaces are treated as
  642.     significant and are saved with the file.  Since the @XFF only
  643.     performs a color change, nothing textual is displayed after the
  644.     spaces, giving you the desired effect.
  645.  
  646.  
  647. Q:  I prefer the status bar format from TheDraw and PCBDraw.  Is there
  648.     anyway to implement this?
  649.  
  650. A:  It's been there since the original release!  You can use the Alt-T
  651.     key to toggle status line types between the default one, one that
  652.     appears more like the TheDraw/PCBDraw status line, or no status line
  653.     at all.  Or you can use the /STATUS configuration option to select
  654.     which one you want by default (/STATUS syntax and options are
  655.     documented above).
  656.  
  657.